home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Tele / C / CutSize1.0a Folder / CutSize Docs < prev    next >
Encoding:
Text File  |  1989-02-04  |  4.3 KB  |  110 lines  |  [TEXT/TPAS]
  1.                               CutSize 1.0a
  2.  
  3.                             by Mark Kupferman
  4.  
  5. What is it?
  6. -----------
  7.  
  8. Cutsize is a short program that allows you to maintain a maximum number of
  9. messages to be allowed in each of your message sections. If the program is
  10. run after Tabby Delivermail, it will tell you how many new messages were
  11. added to each section during the mail hour.
  12.  
  13. What should be in this archive?
  14. -------------------------------
  15.  
  16. Cutsize 1.0a            The compiled program
  17. Cutsize Config          The configuration file
  18. Cutsize.pas             The Turbo Pascal Source
  19. Cutsize.rsrc            The resource file
  20.  
  21. How does it work?
  22. -----------------
  23.  
  24. Let's say you have 3 message sections: EchoMac, MacDev, and Tabby. You have
  25. configured Cutsize to allow the Echomac message base to allow 70 messages,
  26. the MacDev base to allow 50 messages, and the Tabby base to allow 60 
  27. messages. When Cutsize runs, it will count how many messages are in each
  28. of these sections. Let's say if finds 100 active messages in the Echomac
  29. base, 47 in the MacDev base, and 65 in the Tabby base. After it counts, it
  30. will print out a report of how many new messages were put into each of the
  31. section. Then, it will scan the message base again. This time, it will delete
  32. the oldest messages in each base until there are only the allowed number
  33. in each base. For example, it would delete the first 30 messages in the
  34. Echomac base, nothing in the MacDev base, and 5 messages in the Tabby
  35. base. It will then create a list of how many messages it deleted in each
  36. base.
  37.  
  38. How do I configure CutSize?
  39. ---------------------------
  40.  
  41. All of the things Cutsize needs to know are stored in a text file called
  42. 'CutSize Config'. Here is what each line represents:
  43.  
  44. Path to MESSAGES File
  45. Path to MSGHDR file
  46. Path to News HiMark file
  47. Path to report
  48. Path to Application to run next
  49.  
  50. Following that are a list of 255 numbers. These are the maximum number of
  51. messages to allow in each section. The first number is for message section
  52. number 1, and the next is 2, all the way to 255. I am sorry it is a pain to
  53. figure out which is which, but this is a cheap program.
  54.  
  55. Stick Cutsize and CutSize Config into your RRH folder. If you like, you
  56. can put Cutsize into an event so that it replaces the 'Red Ryder Host' 
  57. (Cutsize will automatically branch to Red Ryder Host). It should be noted
  58. that this program does not deal with the LaunchNext file, so it should
  59. be the last event (or something like that). 
  60.  
  61. For example:
  62.  
  63. Tabby SendNews,Tabby SendMail,TabbyNet,ArcMail Extract,
  64. TabbyNet DeliverMail,CutSize
  65.  
  66. Would work. If someone wants to modify the program to deal with the 
  67. LaunchNext file and the scheduler, feel free. The source code for this 
  68. program is included. 
  69.  
  70. Of course, it is also possible to run this program stand alone. In the
  71. field for the program to launch next, direct it to the Finder.  Or, you
  72. could even have it run as a CMD#50. Use your imagination
  73.  
  74. What does the report tell me?
  75. -----------------------------
  76.  
  77. The report is fairly obvious, but there are a couple of fields that could
  78. probably be explained. 'Dead Messages' is the number of deleted messages
  79. that are sitting in your message base. By the way, it should be pointed
  80. out that once this program runs, the message base still needs to be 
  81. backed up using MsgEdit. 
  82.  
  83. 'Total # of messages' is the total number of messages in your message file,
  84. including dead messages. 
  85.  
  86. At the end of the report is a list of all of the message section that you
  87. have configured along with how many messages are in each section.
  88.  
  89. How much does the program cost?
  90. -------------------------------
  91.  
  92. The program is free. You can do what you like with it. It did not take me
  93. very long to write, and it does not offer an incredable number of
  94. features. It is simply something I had to write because my message base
  95. was getting out of hand.
  96.  
  97. The source code is included. You are free to modify it any way you like.
  98. If you want to redistribute your modified version, you must a) give me 
  99. credit for the work I put into it, and also you may not charge any money
  100. for it. I would also appreciate if you told me about changes, but I leave
  101. that to your discretion.
  102.  
  103. If you have any questions or comments, please feel free to send them to me.
  104.  
  105. Mark Kupferman
  106. GEnie : M.S.K.
  107. Fido  : 101/470
  108. BBS   : Tao of Telecommunication (617-527-5677)
  109.  
  110.